Spread Windows Forms 6.0 Product Documentation
SortRows(Int32,Int32,SortInfo[]) Method
See Also  Example Support Options
FarPoint.Win.Spread Assembly > FarPoint.Win.Spread Namespace > SheetView Class > SortRows Method : SortRows(Int32,Int32,SortInfo[]) Method


row
Index of first row in range to sort
rowCount
Number of rows in range to sort
sortInfo
Array of SortInfo objects with the column indexes and sort order

Glossary Item Box

Sorts a range of rows on this sheet according to the specified sort information.

Syntax

Visual Basic (Declaration) 
Public Overloads Function SortRows( _
   ByVal row As Integer, _
   ByVal rowCount As Integer, _
   ByVal sortInfo() As SortInfo _
) As Boolean
Visual Basic (Usage)Copy Code
Dim instance As SheetView
Dim row As Integer
Dim rowCount As Integer
Dim sortInfo() As SortInfo
Dim value As Boolean
 
value = instance.SortRows(row, rowCount, sortInfo)
C# 
public bool SortRows( 
   int row,
   int rowCount,
   SortInfo[] sortInfo
)

Parameters

row
Index of first row in range to sort
rowCount
Number of rows in range to sort
sortInfo
Array of SortInfo objects with the column indexes and sort order

Return Value

Boolean: true if successful; false otherwise

Remarks

Use this method if you want to sort only a range of rows and not the entire sheet.

Use this method if you want to specify more than one column by which to sort, in other words, if you have more than one key for sorting.

The sortInfo array can contain multiple keys (multiple columns) and the first specified column is the primary key, etc. The sortInfo array can also contain multiple ways of comparing the sorted objects and it may be different for each key. For more information, refer to the SortInfo object.

This does not affect the data model, only how the data is displayed. Different overloads provide different ways to sort the rows.

Example

This example sorts a range of rows.
C#Copy Code
fpSpread1.ActiveSheet.SetValue(0, 0, "S");
fpSpread1.ActiveSheet.SetValue(0, 1, "E");
fpSpread1.ActiveSheet.SetValue(0, 2, "A");
fpSpread1.ActiveSheet.SetValue(0, 3, "K");
fpSpread1.ActiveSheet.SetValue(1, 0, "W");
fpSpread1.ActiveSheet.SetValue(1, 1, "G");
fpSpread1.ActiveSheet.SetValue(1, 2, "P");
fpSpread1.ActiveSheet.SetValue(1, 3, "V");
fpSpread1.ActiveSheet.SetValue(2, 0, "O");
fpSpread1.ActiveSheet.SetValue(2, 1, "L");
fpSpread1.ActiveSheet.SetValue(2, 2, "Q");
fpSpread1.ActiveSheet.SetValue(2, 3, "H");
FarPoint.Win.Spread.SortInfo[] sort = new FarPoint.Win.Spread.SortInfo[1];
sort[0] = new FarPoint.Win.Spread.SortInfo(0, true, System.Collections.Comparer.Default);
fpSpread1.ActiveSheet.SortRows(0, 1, sort);
Visual BasicCopy Code
FpSpread1.ActiveSheet.SetValue(0, 0, "S")
FpSpread1.ActiveSheet.SetValue(0, 1, "E")
FpSpread1.ActiveSheet.SetValue(0, 2, "A")
FpSpread1.ActiveSheet.SetValue(0, 3, "K")
FpSpread1.ActiveSheet.SetValue(1, 0, "W")
FpSpread1.ActiveSheet.SetValue(1, 1, "G")
FpSpread1.ActiveSheet.SetValue(1, 2, "P")
FpSpread1.ActiveSheet.SetValue(1, 3, "V")
FpSpread1.ActiveSheet.SetValue(2, 0, "O")
FpSpread1.ActiveSheet.SetValue(2, 1, "L")
FpSpread1.ActiveSheet.SetValue(2, 2, "Q")
FpSpread1.ActiveSheet.SetValue(2, 3, "H")
Dim sort(1) As FarPoint.Win.Spread.SortInfo
sort(0) = New FarPoint.Win.Spread.SortInfo(0, True, System.Collections.Comparer.Default)
FpSpread1.ActiveSheet.SortRows(0, 1, sort)

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

© 2002-2012 ComponentOne, a division of GrapeCity. All Rights Reserved.